레이더

지점별 데이터와 이를 합성한 강수지역, 강수세기, 이동속도 등의 데이터를 영상자료와 데이터파일로 제공합니다.

api 상세
개요

레이더 강수량은 각각의 레이더 관측소에서 생산된 관측자료를 합성하여 우리나라 전역의 레이더 합성영상자료를 산출하고, 이를 활용하여 우리나라에 영향을 주는 강수의 범위와 이동경향감시 분석 등에 이용합니다.
요 소

강수량
지 점

전국
보유기간

2016년 ~ 현재
생산주기

분(10분 주기) 자료

1. 레이더합성자료 다운로드

레이더 합성자료 포맷 정보 참고자료

호출URL정보

이진자료

https://apihub.kma.go.kr/api/typ04/url/rdr_cmp_file.php?tm=202107151200&data=bin&cmp=cpp&authKey=2rSpakFDSja0qWpBQ3o2fg

이미지자료

https://apihub.kma.go.kr/api/typ04/url/rdr_cmp_file.php?tm=202107151200&data=img&cmp=cmb&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명 의미 설명

tm

자료시간

년월일시분(KST)

data

자료형태

bin(이진), img(이미지)

cmp

합성종류

이진 - cpp, ppi. cmx, hsr, hsp
이미지 - cmb, cmc, cmi

authKey

인증키

발급된 API 인증키

2. 행정구역별 레이더합성자료 조회

호출URL정보

레이더지점별QCD한반도조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrRadarInfoService/getSiteCappiQcdAll?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&dataTypeCd=DZ&siteCode=BRI&sweep=0&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

dateTime

관측시간

자료 시간 간격 : 5분 YYYYMMDDHH24MI(최근 2일까지 조회가능)

dataTypeCd

자료구분코드

DZ, VR, SW 등 (하단 첨부참조)

siteCode

지점코드

KWK(관악산) BRI(백령도) 등 (활용가이드 하단 첨부참조)

sweep

스윕 타입

0,1,2,3 등 (활용가이드 하단 첨부 참조)

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

gridKm

격자크기

xdim

X 좌표 개수

ydim

Y 좌표 개수

lon

지점 경도

lat

지점 위도

x0

X 좌표 기준점

y0

Y 좌표 기준점

unit

단위

value

값

호출URL정보

레이더지점별QCD행정구역조회

https://apihub.kma.go.kr/api/typ02/openApi/WthrRadarInfoService/getSiteCappiQcdArea?pageNo=1&numOfRows=10&dataType=XML&dateTime=201911120300&dataTypeCd=DZ&siteCode=BRI&sweep=0&dongCode=1100000000&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

dateTime

관측시간

자료 시간 간격 : 5분 YYYYMMDDHH24MI(최근 2일까지 조회가능)

dataTypeCd

자료구분코드

DZ, VR, SW 등 (하단 첨부참조)

siteCode

지점코드

KWK(관악산) BRI(백령도) 등(하단첨부 참조)

sweep

스윕 타입

0,1,2,3등 (하단첨부 참조)

dongCode

행정구역 코드

행정구역 코드(별첨파일 참고 참조)

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dateTime

관측시간

lon

행정구역 경도

lat

행정구역 위도

unit

단위

value

값

3. (그래픽) 레이더 분포도 조회

호출URL정보

https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-rdr_cmp1_img?tm=202212221010&cmp=HSR&qcd=HSLP&obs=ECHD&color=C4&aws=0&acc=&map=HR&grid=2&legend=1&size=600&itv=5&zoom_level=0&zoom_x=0000000&zoom_y=0000000&gov=&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명 의미 설명

tm

조회할 자료시각

cmp

구분1

HSR, HCI, PPI, CPP, CMX

qcd

구분2

NQC, QCD, EXT

obs

구분3

ECHO, EBH, STN

color

요청한 색상표

aws

지점정보 포함

0:지점표출없음, 1:지점명, 2:지점번호, 3:관측값

acc

seq-seq1(분)

map

사용할 지도코드

grid

격자크기(km)

legend

범례표시(1) 여부

size

이미지크기(픽셀)

itv

시간간격

gov

기관코드

griddisp

격자표출 (0:내삽X, 1:내삽)

강수유무,유형은 내삽X

rnexdisp

강수량에서 강수영역표시

wv

Wind Vector 중첩여부(0:중첩X)

ht

Wind Vector 높이(m)

ta1

ta2

qpf

K(KLAPS), M(MAPLE), B(블랜딩)

eva

평가기준

2:0.1mm, 3:1mm, 4:5mm

option

1(확장영역), 0(중첩영역)

ef

예측시간

+0,+1,,,

authKey

인증키

발급된 API 인증키

호출URL정보

https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-rdr_wis_ana_img?tm=202212221025&obs=wv&wv=0&ht=1400&map=HR&grid=2&legend=1&size=600&itv=5&zoom_level=0&zoom_x=0000000&zoom_y=0000000&gov=&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명 의미 설명

tm

조회할 자료시각

cmp

구분1

HSR, HCI, PPI, CPP, CMX

qcd

구분2

NQC, QCD, EXT

obs

구분3

ECHO, EBH, STN

color

요청한 색상표

aws

지점정보 포함

0:지점표출없음, 1:지점명, 2:지점번호, 3:관측값

acc

seq-seq1(분)

map

사용할 지도코드

grid

격자크기(km)

legend

범례표시(1) 여부

size

이미지크기(픽셀)

itv

시간간격

gov

기관코드

griddisp

격자표출 (0:내삽X, 1:내삽)

강수유무,유형은 내삽X

rnexdisp

강수량에서 강수영역표시

wv

Wind Vector 중첩여부(0:중첩X)

ht

Wind Vector 높이(m)

ta1

ta2

qpf

K(KLAPS), M(MAPLE), B(블랜딩)

eva

평가기준

2:0.1mm, 3:1mm, 4:5mm

option

1(확장영역), 0(중첩영역)

ef

예측시간

+0,+1,,,

authKey

인증키

발급된 API 인증키

호출URL정보

https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-rdr_obs_taH_img?tm=202212221025&obs=taH&ta1=0&ta2=-999&map=HR&grid=2&legend=1&size=600&itv=5&zoom_level=0&zoom_x=0000000&zoom_y=0000000&gov=&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명 의미 설명

tm

조회할 자료시각

cmp

구분1

HSR, HCI, PPI, CPP, CMX

qcd

구분2

NQC, QCD, EXT

obs

구분3

ECHO, EBH, STN

color

요청한 색상표

aws

지점정보 포함

0:지점표출없음, 1:지점명, 2:지점번호, 3:관측값

acc

seq-seq1(분)

map

사용할 지도코드

grid

격자크기(km)

legend

범례표시(1) 여부

size

이미지크기(픽셀)

itv

시간간격

gov

기관코드

griddisp

격자표출 (0:내삽X, 1:내삽)

강수유무,유형은 내삽X

rnexdisp

강수량에서 강수영역표시

wv

Wind Vector 중첩여부(0:중첩X)

ht

Wind Vector 높이(m)

ta1

ta2

qpf

K(KLAPS), M(MAPLE), B(블랜딩)

eva

평가기준

2:0.1mm, 3:1mm, 4:5mm

option

1(확장영역), 0(중첩영역)

ef

예측시간

+0,+1,,,

authKey

인증키

발급된 API 인증키

호출URL정보

https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-qpf_ana_img?tm=202212221025&qpf=M&eva=1&option=1&ef=60&map=HR&grid=2&legend=1&size=600&itv=5&zoom_level=0&zoom_x=0000000&zoom_y=0000000&gov=&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명 의미 설명

tm

조회할 자료시각

cmp

구분1

HSR, HCI, PPI, CPP, CMX

qcd

구분2

NQC, QCD, EXT

obs

구분3

ECHO, EBH, STN

color

요청한 색상표

aws

지점정보 포함

0:지점표출없음, 1:지점명, 2:지점번호, 3:관측값

acc

seq-seq1(분)

map

사용할 지도코드

grid

격자크기(km)

legend

범례표시(1) 여부

size

이미지크기(픽셀)

itv

시간간격

gov

기관코드

griddisp

격자표출 (0:내삽X, 1:내삽)

강수유무,유형은 내삽X

rnexdisp

강수량에서 강수영역표시

wv

Wind Vector 중첩여부(0:중첩X)

ht

Wind Vector 높이(m)

ta1

ta2

qpf

K(KLAPS), M(MAPLE), B(블랜딩)

eva

평가기준

2:0.1mm, 3:1mm, 4:5mm

option

1(확장영역), 0(중첩영역)

ef

예측시간

+0,+1,,,

authKey

인증키

발급된 API 인증키

4. (그래픽) 레이더 합성영상 조회(배경지도 없음)

출력결과는 투영법, 이미지파일 위치 등이 JSON 포맷으로 표출됨 ※ url 이후 나오는 경로 앞에 https://apihub.kma.go.kr을 붙여서 사용

호출URL정보

레이더-HSR

https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-rdr_cmp1_imgp?PROJ=LCC&cmp=HSP&obs=ECHD&qcd=HSLP&grid=2&itv=10&tm_mode=m10&data0=RCM&level=C&map=R&dtm=m0&zoom_level=0&zoom_rate=2&zoom_x=0000000&zoom_y=0000000&auto_man=a&mode=H&umove=10&fmove=2&dmove=180&bmove=10&winnum=0&rand=10&size=320&an_frn=1&an_itv=1&river=on&road=on&city=on&gis_auto=on&stnname=on&ctrl=0&dataDtlCd=rdr_hsr_0&data1=h01&data2=hsr&data3=0&overlay=spr&color=C4&effect=N&height=320&qpf=M&ef=&legend=1&STARTX=-384032.28285233676&STARTY=4878817.500765007&ENDX=758967.7171476632&ENDY=3778150.834098339&ZOOMLVL=11&selWs=kh&tm=202307201700&tm_st=202307201700&tm_ed=202307201700&tm2=202307201700&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명 의미 설명

PROJ

경량화 PROJECT ID

cmp

HSR, HCI, PPI, CPP, CMX

obs

변수 구분 (예: ta)

STARTX

시작 X 좌표

STARTY

시작 Y 좌표

ENDX

종료 X 좌표

ENDY

종료 Y 좌표

ZOOMLVL

현재 줌 Level

tm

현재시각

tm_st

시작 시각

qcd

AWS3 QCD 자료

grid

격자크기(km)

itv

표출시간단위(분)

tm_mode

data0

자료종류

level

이미지 단계표

map

지도종류

사용할 지도코드

dtm

시간이동단위 및 이동값

zoom_level

zoom_rate

확대율

zoom_x

X축 확대지역

zoom_y

Y축 확대지역

auto_man

자동여부

mode

표출양식

html(H), image(I), auto(A), file(F)

umove

최근 및 과거자료 찾기 위한 시간이동 간격(분)

fmove

최근 자료파일의 생성 지연 시각(분)

dmove

최근 자료파일을 찾기 위한 시간(분)

bmove

요청시간 직전의 자료파일을 찾기 위한 시간(분)

winnum

WINDOW 번호(for auto mode)

rand

난수

이미지 재생성 시간간격(분)

size

이미지크기(픽셀)

an_frn

동화 프레임수

an_itv

동화 시간간격(분)

river

road

city

gis_auto

stnname

지점명

ctrl

dataDtlCd

경량화 Layer Name

data1

변수종류

data2

변수종류

data3

변수종류

overlay

이미지 중첩

color

요청한 색상표

effect

이미지 효과

height

별도의 color level bar image height

qpf

K(KLAPS), M(MAPLE), B(블랜딩)

ef

예측시간

(+0,+1,,,)

legend

범례표시 여부

authKey

인증키

발급된 API 인증키

호출URL정보

레이더-바람

https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-rdr_wis_ana_imgp?PROJ=LCC&cmp=HSR&obs=wv&qcd=NQC&grid=2&itv=10&tm_mode=m10&data0=RCM&level=C&map=R&dtm=m0&zoom_level=0&zoom_rate=2&zoom_x=0000000&zoom_y=0000000&auto_man=1&mode=H&umove=10&fmove=2&dmove=180&bmove=10&winnum=0&rand=10&size=320&an_frn=1&an_itv=1&river=on&road=on&city=on&gis_auto=on&stnname=on&ctrl=0&dataDtlCd=rdr_rdr_wis_nqc_0&data1=r01&data2=rdr_wis_nqc&data3=0&overlay=spr&color=C4&effect=N&height=320&qpf=M&ef=120&eva=1&option=1&legend=1&acc=180&sms=1&STARTX=-384032.28285233676&STARTY=4878817.500765007&ENDX=758967.7171476632&ENDY=3778150.834098339&ZOOMLVL=11&selWs=kh&tm=202307201700&tm_st=202307201700&tm_ed=202307201700&tm2=202307201700&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명 의미 설명

PROJ

경량화 PROJECT ID

cmp

HSR, HCI, PPI, CPP, CMX

obs

변수 구분 (예: ta)

STARTX

시작 X 좌표

STARTY

시작 Y 좌표

ENDX

종료 X 좌표

ENDY

종료 Y 좌표

ZOOMLVL

현재 줌 Level

tm

현재시각

tm_st

시작 시각

qcd

AWS3 QCD 자료

grid

격자크기(km)

itv

표출시간단위(분)

tm_mode

data0

자료종류

level

이미지 단계표

map

지도종류

사용할 지도코드

dtm

시간이동단위 및 이동값

zoom_level

zoom_rate

확대율

zoom_x

X축 확대지역

zoom_y

Y축 확대지역

auto_man

자동여부

mode

표출양식

html(H), image(I), auto(A), file(F)

umove

최근 및 과거자료 찾기 위한 시간이동 간격(분)

fmove

최근 자료파일의 생성 지연 시각(분)

dmove

최근 자료파일을 찾기 위한 시간(분)

bmove

요청시간 직전의 자료파일을 찾기 위한 시간(분)

winnum

WINDOW 번호(for auto mode)

rand

난수

이미지 재생성 시간간격(분)

size

이미지크기(픽셀)

an_frn

동화 프레임수

an_itv

동화 시간간격(분)

river

road

city

gis_auto

stnname

지점명

ctrl

dataDtlCd

경량화 Layer Name

data1

변수종류

data2

변수종류

data3

변수종류

overlay

이미지 중첩

color

요청한 색상표

effect

이미지 효과

height

별도의 color level bar image height

qpf

K(KLAPS), M(MAPLE), B(블랜딩)

ef

예측시간

(+0,+1,,,)

legend

범례표시 여부

authKey

인증키

발급된 API 인증키

호출URL정보

레이더-빙결고도

https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-rdr_obs_taH_imgp?PROJ=LCC&cmp=SFC&obs=taH&qcd=NQC&grid=2&itv=10&tm_mode=m10&data0=RCM&level=C&map=R&dtm=m0&zoom_level=0&zoom_rate=2&zoom_x=0000000&zoom_y=0000000&auto_man=1&mode=H&umove=10&fmove=2&dmove=180&bmove=10&winnum=0&rand=10&size=320&an_frn=1&an_itv=1&river=on&road=on&city=on&gis_auto=on&stnname=on&ctrl=0&dataDtlCd=rdr_rdr_taH_nqc_0&data1=r01&data2=rdr_taH_nqc&data3=0&overlay=spr&color=C4&effect=N&height=320&qpf=M&ef=120&eva=1&option=1&legend=1&acc=180&sms=1&STARTX=-384032.28285233676&STARTY=4878817.500765007&ENDX=758967.7171476632&ENDY=3778150.834098339&ZOOMLVL=11&selWs=kh&tm=202307201700&tm_st=202307201700&tm_ed=202307201700&tm2=202307201700&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명 의미 설명

PROJ

경량화 PROJECT ID

cmp

HSR, HCI, PPI, CPP, CMX

obs

변수 구분 (예: ta)

STARTX

시작 X 좌표

STARTY

시작 Y 좌표

ENDX

종료 X 좌표

ENDY

종료 Y 좌표

ZOOMLVL

현재 줌 Level

tm

현재시각

tm_st

시작 시각

qcd

AWS3 QCD 자료

grid

격자크기(km)

itv

표출시간단위(분)

tm_mode

data0

자료종류

level

이미지 단계표

map

지도종류

사용할 지도코드

dtm

시간이동단위 및 이동값

zoom_level

zoom_rate

확대율

zoom_x

X축 확대지역

zoom_y

Y축 확대지역

auto_man

자동여부

mode

표출양식

html(H), image(I), auto(A), file(F)

umove

최근 및 과거자료 찾기 위한 시간이동 간격(분)

fmove

최근 자료파일의 생성 지연 시각(분)

dmove

최근 자료파일을 찾기 위한 시간(분)

bmove

요청시간 직전의 자료파일을 찾기 위한 시간(분)

winnum

WINDOW 번호(for auto mode)

rand

난수

이미지 재생성 시간간격(분)

size

이미지크기(픽셀)

an_frn

동화 프레임수

an_itv

동화 시간간격(분)

river

road

city

gis_auto

stnname

지점명

ctrl

dataDtlCd

경량화 Layer Name

data1

변수종류

data2

변수종류

data3

변수종류

overlay

이미지 중첩

color

요청한 색상표

effect

이미지 효과

height

별도의 color level bar image height

qpf

K(KLAPS), M(MAPLE), B(블랜딩)

ef

예측시간

(+0,+1,,,)

legend

범례표시 여부

authKey

인증키

발급된 API 인증키

호출URL정보

레이더-1H예측

https://apihub.kma.go.kr/api/typ03/cgi/rdr/nph-qpf_ana_imgp?PROJ=LCC&cmp=HSR&obs=qpf&qcd=EXT&grid=2&itv=10&tm_mode=m10&data0=RCM&level=C&map=R&dtm=m0&zoom_level=0&zoom_rate=2&zoom_x=0000000&zoom_y=0000000&auto_man=1&mode=H&umove=10&fmove=2&dmove=180&bmove=10&winnum=0&rand=10&size=320&an_frn=1&an_itv=1&river=on&road=on&city=on&gis_auto=on&stnname=on&ctrl=0&dataDtlCd=rdr_rdr_qpf_ana1_0&data1=r01&data2=rdr_qpf_ana1&data3=0&overlay=spr&color=C4&effect=N&height=320&qpf=M&ef=60&eva=1&option=1&STARTX=-384032.28285233676&STARTY=4878817.500765007&ENDX=758967.7171476632&ENDY=3778150.834098339&ZOOMLVL=11&selWs=kh&tm=202307201700&tm_st=202307201700&tm_ed=202307201700&tm2=202307201700&authKey=2rSpakFDSja0qWpBQ3o2fg

요청인자

데이터 기본 정보
인자명 의미 설명

PROJ

경량화 PROJECT ID

cmp

HSR, HCI, PPI, CPP, CMX

obs

변수 구분 (예: ta)

STARTX

시작 X 좌표

STARTY

시작 Y 좌표

ENDX

종료 X 좌표

ENDY

종료 Y 좌표

ZOOMLVL

현재 줌 Level

tm

현재시각

tm_st

시작 시각

qcd

AWS3 QCD 자료

grid

격자크기(km)

itv

표출시간단위(분)

tm_mode

data0

자료종류

level

이미지 단계표

map

지도종류

사용할 지도코드

dtm

시간이동단위 및 이동값

zoom_level

zoom_rate

확대율

zoom_x

X축 확대지역

zoom_y

Y축 확대지역

auto_man

자동여부

mode

표출양식

html(H), image(I), auto(A), file(F)

umove

최근 및 과거자료 찾기 위한 시간이동 간격(분)

fmove

최근 자료파일의 생성 지연 시각(분)

dmove

최근 자료파일을 찾기 위한 시간(분)

bmove

요청시간 직전의 자료파일을 찾기 위한 시간(분)

winnum

WINDOW 번호(for auto mode)

rand

난수

이미지 재생성 시간간격(분)

size

이미지크기(픽셀)

an_frn

동화 프레임수

an_itv

동화 시간간격(분)

river

road

city

gis_auto

stnname

지점명

ctrl

dataDtlCd

경량화 Layer Name

data1

변수종류

data2

변수종류

data3

변수종류

overlay

이미지 중첩

color

요청한 색상표

effect

이미지 효과

height

별도의 color level bar image height

qpf

K(KLAPS), M(MAPLE), B(블랜딩)

ef

예측시간

(+0,+1,,,)

legend

범례표시 여부

authKey

인증키

발급된 API 인증키